home *** CD-ROM | disk | FTP | other *** search
/ Aminet 30 / Aminet 30 (1999)(Schatztruhe)[!][Apr 1999].iso / Aminet / util / boot / RemAPollo.lha / RemAPollo.doc.pl < prev    next >
Text File  |  1999-01-17  |  15KB  |  349 lines
  1.                              RemAPollo V0.97 BETA
  2.  
  3.                        Produkt Eccentric Creations (TM)
  4.  
  5.                   (c) Mikolaj Calusinski 1998-99. Freeware.
  6.  
  7.                              Instrukcja obsîugi.
  8.  
  9. Wstëp
  10. -----
  11.  
  12. RemAPollo - A1200 040\060 MMU Apollo Turboboard Remapper jest pakietem
  13. freeware (uûywanie go nie wymaga rejetracji ani ûadnych opîat), ale autor
  14. zastrzega sobie wszystkie prawa autorskie. Pakiet zostaî napisany pod wpîywem
  15. mojej rozpaczy, wynikajâcej z braku moûliwoôci podmiany Kickstartu przez
  16. uûytkowników kart Apollo. My, posiadacze tychûe kart byliômy w gorszej
  17. sytuacji, niû wîaôciciele kart typu Blizzard, którzy mogli w dziecinnie prosty
  18. sposób (ustawiajâc jednâ zworkë na karcie) "podmieniê" sobie ROM. My nie
  19. moûemy tego zrobiê - nasze karty nie posiadajâ takich zworek, dodatkowo nie
  20. byîo dotychczas programów umoûliwiajâcych nam takâ operacjë w sposób czysto
  21. programowy. Mam nadziejë, ûe ta nierównoôê zostanie niniejszym wyrównana przez
  22. RemAPollo.
  23.  
  24. Zwróê uwagë, ûe RemAPollo jest jeszcze w fazie testów próbnych, wiëc
  25. wystâpienie problemów jest wysoce prawdopodobne. Jeûeli wykryjesz jakiekolwiek
  26. nieprawidîowoôci w dziaîaniu programu, skontaktuj sië ze mnâ; szczegóîowe
  27. opisy bîëdów mile widziane. Mój adres znajdziesz w rozdziale 'Autor'. Ponadto
  28. upewnij sië, ûe uwaûnie przeczytaîeô të instrukcjë!
  29.  
  30. Rozpowszechnianie
  31. -----------------
  32.  
  33. Pakiet RemAPollo moûe byê swobodnie rozpowszechniany, przy uwzglëdnieniu
  34. poniûszych kryteriów:
  35.  
  36.  
  37.  - Ûaden z plików, wchodzâcych w skîad pakietu nie moûe byê modyfikowany, ani
  38.    pominiëty.
  39.  
  40.  - Nie moûna pobieraê ûadnych opîat za pakiet, z wyjâtkiem kosztu noônika i
  41.    opîat manipulacyjnych.
  42.  
  43.  - Pakiet RemAPollo moûe byê doîâczany do zestawów darmowego oprogramowania,
  44.    ale nie moûe byê zamieszczany na komercyjnych pîytach CD-ROM (wîâczajâc w
  45.    to pîyty doîâczane do czasopism tzw. coverdyski). Jeûeli chesz zamieôciê
  46.    ten pakiet na swoim CD-ROMie musisz najpierw zwróciê sië do mnie o
  47.    wyraûenie zgody. Powyûsze nie dotyczy pîyt AminetCD; Administrator Aminetu,
  48.    Urban MÜller, ma mojâ zgodë na umieszczanie pakietu RemAPollo na tychûe
  49.    pîytach.
  50.  
  51.  - Pakiet RemAPollo nie moûe byê doîâczany do jakiegokolwiek komercyjnego
  52.    produktu, bez mojej pisemnej zgody.
  53.  
  54. Ostrzeûenie
  55. -----------
  56.  
  57. UÛYWASZ PLIKÓW, WCHODZÂCYCH W SKÎAD PAKIETU RemAPollo CAÎKOWICIE NA WÎASNE
  58. RYZYKO. NIE PONOSZË ÛADNEJ ODPOWIEDZIALNOÔCI ZA SZKODY SPOWODOWANE
  59. UÛYTKOWANIEM TEGO PAKIETU!
  60.  
  61. Do czego to wîaôciwie sîuûy?
  62. ----------------------------
  63.  
  64. RemAPollo jest pakietem programów stworzonych dla uûytkowników komputera Amiga
  65. 1200, wyposaûonego w kartë turbo Apollo 040/060. W jego skîad wchodzi kilka
  66. plików sîuûâcych do podmieniania Kickstartu - czëôci systemu operacyjnego
  67. Amigi, znajdujâcej sië w ROMie. Moûesz przenieôê Kickstart, który masz
  68. zapisany w ROMie do szybkiej pamiëci, bâdú teû uûyê zupeînie innej wersji
  69. Kickstartu (szczególnie przydatne, gdy jesteô programistâ). Wiëcej szczegóîów
  70. w rozdziale "Korzystanie z pakietu".
  71.  
  72. Wymagania
  73. ---------
  74.  
  75. Dla poprawnego dziaîania pakietu sâ wymagane: 
  76.  
  77. - komputer Amiga 1200
  78.  
  79. - przynajmniej wersja 2.0 (V36) systemu operacyjnego (to chyba nie jest
  80.   problem :-)
  81.  
  82. - karta turbo Apollo 040 lub 060 (procesor musi posiadaê sprawny MMU),
  83.   wyposaûona w przynajmniej 1 MB pamiëci fast
  84.  
  85. - oryginalna biblioteka 040.library pochodzâca z Commodore w wersjach 37.10
  86.   lub 37.30, jeûeli uûywasz procesora 68040 albo biblioteka 060.library
  87.   doîâczana do karty turbo (obecnie program wspóîpracuje tylko z wersjâ
  88.   60.10), jeûeli uûywasz procesora 68060.
  89.  
  90.  
  91. Instalacja
  92. ----------
  93.  
  94. Instalacja, jakkolwiek prosta, skîada sië z kilku czynnoôci, które powinny byê
  95. wykonane starannie i uwaûnie, w przeciwnym razie system prawie na pewno bëdzie
  96. sprawiaî problemy. Poniewaû RemAPollo nie jest przeznaczony dla
  97. niedoôwiadczonych uûytkowników, w pakiecie nie ma skryptu instalacyjnego -
  98. caîâ pracë musisz wykonaê rëcznie.
  99.  
  100.                                       1.
  101.  
  102. Najpierw - to bardzo waûne - powinieneô zaktualizowaê plik 040(060).library. W
  103. archiwum z programem znajdziesz specjalny program "patch" do tego celu. Jeûeli
  104. Twoja 040(060).library znajduje sië w katalogu LIBS: i nie zostaîa spakowana,
  105. wystarczy jedynie uruchomiê program "patch" bez ûadnych parametrów. Program
  106. poinformuje Cië o wyniku swojej pracy, niestety tylko po angielsku. UWAGA! W
  107. przypadku procesora 68040 upewnij sië, ûe uûywana przez Ciebie 040.library
  108. pochodzi z Commodore; jeûeli wykorzystujesz bibliotekë pochodzâcâ z innych
  109. úródeî (np. z Phase5) musisz z niej zrezygnowaê. W szczególnoôci remaper nie
  110. bëdzie wspóîpracowaî z bibliotekami Phase5; ich uûywanie nie wpîywa na lepsze
  111. funkcjonowanie kart Apollo.
  112.  
  113. Jeôli Twoja biblioteka jest spakowana, najpierw rozpakuj jâ, a nastëpnie
  114. wywoîaj program "patch" podajâc ôcieûkë dostëpu do niej. Po skoïczonej
  115. operacji moûesz spakowaê bibliotekë ponownie.
  116.  
  117. Powyûsza czynnoôê jest ABSOLUTNIE konieczna, dla prawidîowej pracy systemu z
  118. podmienionym Kickstartem. Twoja Amiga moûe dziaîaê poprawnie bez dokonywania
  119. zmian w pliku 040(060).library, ale nie wprowadzajâc ich sam prosisz sië o
  120. kîopoty; za którymô razem system moûe sië "zawiesiê". Jeûeli chcesz dowiedzieê
  121. sië czegoô wiëcej o zmianach wykonywanych przez program "patch" przeczytaj
  122. rozdiaî "Informacje dodatkowe".
  123.  
  124.                                       2.
  125.  
  126. Po zakoïczeniu operacji uaktualniania biblioteki powinieneô skopiowaê program
  127. DRAP (Apollo Remapper Deallocator) do katalogu C:, po czym umieôciê jego
  128. wywoîanie w sekwencji startowej (startup-sequence) w pierwszej linii po
  129. SetPatchu. Odpowiedni fragment Twojego startupu powinien wiëc wyglâdaê tak:
  130.  
  131. ...
  132. SetPatch QUIET
  133. DRAP
  134. ...
  135.  
  136. Stosowanie tego programiku nie jest wymagane dla poprawnego funkcjonowania
  137. relokacji, ale jego uûycie jest ze wszech miar polecane. Jego dziaîanie polega
  138. m.in. na zwolnieniu pamiëci allokowanej przez remaper (dokîadnie 67712
  139. bajtów) i doproweadzeniu systemu do bardziej efektywnego i stabilnego stanu.
  140. Jeûeli zamierzasz korzystaê z funkcji MAC (patrz rozdziaî "Korzystanie z
  141. pakietu") ten program *MUSI* zostaê uruchomiony, w przeciwnym razie emulator
  142. "zawiesi" sië. Uûywanie DRAPa przyspieszy teû nieco pracë systemu, poniewaû
  143. przenosi pierwszâ stronë pamiëci (pierwszy kilobajt) z wooolnej pamiëci chip
  144. do pamiëci fast. Wreszcie, zabezpieczy on zmapowany Kickstart przed zapisem.
  145. Moûesz umieôciê DRAPa w startup-sequence na staîe - w przypadku nie wykrycia
  146. relokacji nie robi on nic, z wyjâtkiem ustawienia kodu wyjôciowego (RC) na 5.
  147.  
  148.                                       3.
  149.  
  150. Kiedy powyûsze punkty zostanâ zrealizowane moûesz uûyê gîównego programu z
  151. pakietu (patrz rozdziaî "Korzystanie z pakietu").
  152.  
  153. Relokacja pozostanie aktywna tak dîugo, jak dîugo nie zostanâ naruszone: baza
  154. biblioteki exec ani wektor ColdCapture. Aby pozbyê sië jej z pamiëci uûyj
  155. zaîâczonego w pakiecie programu "Reset" z opcjâ HARD. Program ten wyczyôci
  156. lokacjë 4, usuwajâc z systemu wszelkie rezydenty.
  157.  
  158. Korzystanie z pakietu
  159. ---------------------
  160.  
  161. Gîówny program pakietu RemAPollo (o tej samej nazwie) moûe byê uruchomiony
  162. zarówno z CLI jak i z Workbencha. Tooltypy sâ praktycznie identyczne z
  163. parametrami CLI, w zwiâzku z czym omówimy tylko te ostatnie.
  164.  
  165. Standardowa skîadnia (uzyskiwania poprzez wpisanie "?" jako parametru) wyglâda
  166. tak:
  167.  
  168. KICKFILE,MAC/S,NF=NOPAGEFIX/S,FORCE/S,QUIET/S:
  169.  
  170. Ûaden z parametrów nie jest wymagany. Jeûeli nie podasz wcale argumentów
  171. aktualny ROM zostanie zmapowany, a komputer wykona reset. Amiga zgîosi sië z
  172. tym samym Kickstartem co w ROMie, z jednâ niezwykle uûytecznâ róûnicâ: pamiëc
  173. fast jest przyîâczana w bardzo wczesnej fazie startu systemu (odpada
  174. koniecznoôê uûywania programów typu FastExec). Dziëki temu moûesz takûe
  175. zakîadaê dyski wirtualne RAD w pamiëci fast!
  176.  
  177. KICKFILE - ten parametr jest uûywany do zlokalizowania pliku z obrazem
  178. Kickstartu, którego chcesz uûywaê. Obsîugiwane sâ tylko Kickstarty 512kB,
  179. zawierajâce nagîówek $1114 i poprawnâ sumë kontrolnâ. RemAPollo nie
  180. wspóîpracuje z Kickstartami 1.x (256kB).
  181.  
  182. MAC - uûyj tej opcji, jeûeli korzystasz z programowego emulatora komputerów
  183. Macintosh. Spowoduje ona rezerwacjë pierwszych 16kB pamiëci chip, czego
  184. wymagajâ te programy. Nie musisz juû uûywaê programów typu RsrvCold, RsrvWarm
  185. czy PrepareEmul w swoim startup-sequence. Nie zapomnij wywoîaê programu "DRAP"
  186. zaraz po SetPatchu!
  187.  
  188. NF lub NOPAGEFIX - ta opcja ma sens tylko przy Kickstarcie 2.x; w wersjach 3.x
  189. jest ignorowana. Jest uûywana do wyîâczenia poprawki w systemie, dotyczâcej
  190. pierwszej strony pamiëci, a dokonywaniej automatycznie przez remapera. Na
  191. Kickstartach 2.x pamiëê chip jest przyîâczana do systemu od lokacji $400.
  192. Poniewaû MMU procesorów 040 i 060 moûe pracowaê z najmniejszâ rozdzielczoôciâ
  193. 4kB, lepiej jest, aby pamiëê byîa odpowiednio do tego wyrównana (czyli
  194. zaczynaîa sië od adresu $1000). Aby tego dokonaê mapper poprawia procedurë
  195. inicjalizacji systemu; poczâwszy od Kickstartu 3.x ta poprawka nie jest juû
  196. potrzebna. Jeôli z jakiegoô powodu nie chcesz zmieniaê oryginalnego zachowania
  197. sië systemu 2.x przy przyîâczaniu pamiëci chip uûyj opcji NOPAGEFIX. Parametr
  198. ten nic nie robi w przypadku uûycia opcji MAC.
  199.  
  200. FORCE - uûywany jeûeli relokacja jest juû aktywna i chcesz wymusiê ponowne
  201. uûycie mappera. Normalnie remaper nie bëdzie staraî sië dokonaê relokacji,
  202. jeôli stwierdzi takowâ w pamiëci (umoûliwia to stosowanie mappera w
  203. startup-sequence bez ciâgîych resetów komputera).
  204.  
  205. QUIET - idealna opcja dla chcâcych wykorzystywaê mappera na staîe (w
  206. startupie); powoduje wyîâczenie wypisywania tekstów i skraca oczekiwanie na
  207. reset komputera.
  208.  
  209. O ile nie wybraîeô opcji QUIET, moûesz przerwaê proces mapowania wciskajâc
  210. jednoczeônie klawisze "control" i "c" (CTRL-C).
  211.  
  212. Jeûeli potrzebny Ci przykîad, oto co mam umieszczone w pierwszej linii mojego
  213. startupu:
  214.  
  215. RemAPollo MAC QUIET
  216.  
  217. Mam Kickstart 3.1 w ROMie, wiëc nie muszë podawaê nazwy pliku. Jeôli uûywasz
  218. Kickstartu 3.0, powinieneô wpisaê coô w tym stylu:
  219.  
  220. RemAPollo DEVS:Kickstart3.1 MAC QUIET
  221.  
  222. Oczywiôcie, zakîadam ûe posiadasz odpowiedni plik w DEVS:.
  223.  
  224. Informacje dodatkowe
  225. --------------------
  226.  
  227. Rezydentny kod remapera jest zabezpieczony sumâ kontrolnâ aby zapewniê
  228. wîaôciwy start komputera - jeôli zostanie wykryta jakakolwiek zmiana w tym
  229. kodzie, program ustawi ekran na czerwono i zresetuje Amigë.
  230.  
  231. Mapper korzysta z wektora ColdCapture, aby przetrwaê pomiëdzy resetami, wiëc
  232. nie powinieneô uûywaê ûadnych programów posîugujâcych sië nim. Dodatkowo jest
  233. równieû podmieniany wektor bus error procesora ($00000008) i powinien pozostaê
  234. niezmieniony, dopóki nie zostanie zainicjalizowana 040(060).library, co
  235. normalnie wykonuje SetPatch. Dopiero po tym powinieneô uruchomiê program DRAP,
  236. aby przywróciê oryginalnâ postaê tego wektora. Weú powyûsze pod uwagë podczas
  237. sprawdzania systemu programem antywirusowym.
  238.  
  239. Aby zmapowaê Kickstart, RemAPollo musi zbudowaê tabele MMU, co zajmuje pamiëê.
  240. Staraîem sië ograniczyê jej wielkoôê do niezbëdnego minimum, w zwiâzku z czym
  241. mapper uûywa 8 kB tablic MMU. Niestety takie rozwiâzanie powoduje konflikt ze
  242. sposobem, w jaki biblioteki 040.library i 060.library instalujâ swoje 4 kB
  243. tablice. Nie wyîâczajâ one MMU przed zaîadowaniem tzw. root pointerów co
  244. prowadzi do nieprzewidywalnych reakcji systemu. Spójrz na odnoôny fragment
  245. kodu 040.library w wersji 37.30:
  246.  
  247. (wejôcie w të procedurë nastëpuje z wîâczonym MMU, ustawionym na tryb 8k)
  248.  
  249.     ori.w    #$700,SR
  250.     pflusha
  251.     move.l    (A0)+,D0
  252.     movec    D0,URP        ;!!! URP wskazuje na 4k tablice!!!
  253.     move.l    (A0)+,D0
  254.     movec    D0,SRP        ;!!! SRP wskazuje na 4k tablice!!! - BUUUM!
  255.     move.l    (A0)+,D0
  256.     movec    D0,TC        ;MMU zostaje przeîâczony na tryb 4k, trochë póúno...
  257.     pflusha
  258.     moveq    #0,D0
  259.     movec    D0,ITT0
  260.     movec    D0,ITT1
  261.     movec    D0,DTT0
  262.     movec    D0,DTT1
  263.     rte
  264.  
  265. Aby ta procedura dziaîaîa naleûy dodaê nastëpujâcy kod:
  266.  
  267.     ori.w    #$700,SR
  268.     moveq    #0,d0
  269.     movec    d0,TC        ;wyîâcz MMU
  270.     pflusha
  271.  
  272. ... i to wîaônie robi program "patch".
  273.  
  274. Bîëdy
  275. -----
  276.  
  277. Nie stwierdzono. (Ale zróûnicowanie systemów na których pakiet byî testowany
  278. byîo niewielkie).
  279.  
  280. Historia
  281. --------
  282.  
  283. V0.1ALFA - (??.9.98) - wersje wewnëtrzne tylko do wîasnego uûytku
  284.  
  285. V0.96ß - (23.12.98) - pierwsza wersja semi-publiczna (dla wybranych testerów)
  286.  
  287. V0.97ß - (1.1.99) zmiany:
  288.  - cache procesora sâ inwalidowane przed wîâczeniem
  289.  - wîâczany jest tylko cache dla instrukcji
  290.  - kod rezydentny sprawdza teraz sumë kontrolnâ Kickstartu (jeôli
  291.    nieprawidîowa, komputer jest resetowany z usuniëciem mapera z pamiëci)
  292.  
  293. V0.973ß - (8.1.99)
  294.  - poprawione rozpoznawanie przez Kickstart pamiëci tzw. slow ($c00000); to
  295.    powino wyeliminowaê zawieszanie sië mapera na niektórych systemach. Dziëki
  296.    dla Arkadiusza Winiarka i Marcina Ostrowskiego za zwrócenie uwagi na ten
  297.    problem.
  298.  
  299. V0.974ß - (12.1.99)
  300.  - po wykryciu procesora 68060, maper ustawia odpowiedniâ flage w strukturze
  301.    biblioteki exec
  302.  
  303. V0.975ß - (13.1.99)
  304.  - inteligentniejsze rozpoznawanie relokacji przez maper, dziëki czemu moûna
  305.    uûywaê niektórych (dobrze napisanych) programów, które wykorzystujâ wektor
  306.    coldcapture. Pierwsza wersja publiczna.
  307.  
  308.  
  309. Podziëkowania
  310. -------------
  311.  
  312. Wielkie dziëki Harremu Sintonenowi, który przesîaî mi kilka wstëpnych
  313. informacji dotyczâcych MMU procesora 040. Byîo to dawno temu, ale pomogîy mi
  314. one rozpoznaê problem, z którym zamierzaîem sië zmierzyê.
  315.  
  316. Ciepîe buziaczki dla firmy Motorola ;-) za znakomity dziaî dystrybucji
  317. literatury, który zapewnia wszystkim chëtnym dostëp do szerokiego wyboru
  318. drukowanych materiaîów; a wszystko to caîkowicie za darmo!
  319.  
  320. Wreszcie dziëki wszystkim alfatesterom, którzy zgodzili sië ryzykowaê
  321. stabilnoôê swych systemów, zmagajâc sië z licznymi wresjami pakietu RemAPollo
  322. (szczególnie dziëkujë Marcinowi Ostrowskiemu, który pomógî mi namierzyê bardzo
  323. powaûny bîâd; mam nadziejë, ûe uda Ci sië w koïcu opanowaê system... ;)
  324.  
  325. Arkadiuszowi Winiarkowi za wytrwaîoôê i pomoc w debugowaniu oraz za wywieranie
  326. presji. ;) Dziëki Tobie RemAPollo chodzi na 060.
  327.  
  328. Mojemu bratu Jackowi za niniejsze tîumaczenie.
  329.  
  330. Ten program dedykujë Ministry - zespoîowi tworzâcemu muzykë, nie wszechobecne
  331. g...no, jakim jest rap.
  332.  
  333. Autor
  334. -----
  335. Mój adres e-mail (preferowana forma kontaktu): bloelle@priv.gold.pl lub
  336. bloelle@polbox.com
  337.  
  338.  
  339. oraz adres dla zwykîej poczty:
  340.  
  341.                               Mikolaj Caîusiïski
  342.                             ul. Olsztyïska 113/117
  343.                               42-200 Czëstochowa
  344.  
  345. Mam nadziejë, ûe ten program przyda Ci sië. Baw sië dobrze!
  346.                                                             Mikoîaj.
  347.  
  348.       ------------> AMIGA - NAJLEPSZY KOMPUTER POD SÎOÏCEM <------------
  349.